挺好用!Shell脚本日志技巧

您所在的位置:网站首页 shell 日志文件不刷新 挺好用!Shell脚本日志技巧

挺好用!Shell脚本日志技巧

2024-07-16 21:13:41| 来源: 网络整理| 查看: 265

本文转载自微信公众号「Linux开发那些事儿」,作者LinuxThings。转载本文请联系Linux开发那些事儿公众号。

执行shell脚本时,常常会打印一些日志到控制台,根据输出的日志,来判断脚本功能正确与否

但是,太多日志打印的话,会让阅读变得很困难,从日志信息里面找到我们关心的那部分也变得很不方便了

所以,有一个好用的shell脚本日志接口是非常有必要的,本文将聊聊实践中日志打印的一些技巧

常见日志打印方式

编写 shell 脚本时,最简单的日志打印是使用 echo 输出,比如: 下面是打印一个测试程序的日志

[root@VM-0-2-centos ~]# echo "this is a log test..."this is a log test...

上面的方式使用起来非常简单,编写效率也很高,对于一些功能简单,代码量少的shell脚本,非常适合这种日志打印的方式,简单快捷

通用接口

上面的小节中,每次都用 echo ,没有一个统一的输出格式,如果需要在每条日志开头加上指定内容, 就需要修改脚本中每一处的日志,这就变成了一个体力活了

针对这点,可以定义一个输出函数,所有的的输出统一调用这个函数, 现有测试脚本 t.sh 内容如下

#!/bin/bash function log() { echo "$@"}

另外新建一个测试脚本 ta.sh

#!/bin/bash source ./t.sh log "this is a test..."log "today is `date '+%Y-%m-%d'` "

执行 ./ta.h 命令,结果如下

[root@VM-0-2-centos shell_log]# ./ta.sh this is a test... today is 2021-07-27

如果现在想在每一行日志前面加上当前时间的话,直接修改 t.sh 中的 log 函数, t.sh调整后的脚本如下

#!/bin/bash function log() { echo "$(date '+%Y-%m-%d %H:%M:%S') $@"}

然后再次执行 ./ta.sh 命令,结果如下

[root@VM-0-2-centos shell_log]# ./ta.sh 2021-07-27 19:55:54 this is a test... 2021-07-27 19:55:54 today is 2021-07-27

上面只修改了 log 函数,ta.sh 中的每一行日志开头就都输出了当前的时间, $@ 表示传入log 函数的所有参数

打印开关

调试脚本的时候,会加上很多的日志打印,当调试完了之后,需要关闭所有的日志输出,上面已经把日志打印统一到一个函数中了,这时我们只需要禁止执行 log 函数的 echo 语句即可,修改之后的 t.sh 内容如下

#!/bin/bash function log() { [ 0 -gt 1 ] && echo "$(date '+%Y-%m-%d %H:%M:%S') $@"}

当 [ 0 -gt 1 ] 表示条件结果为 false 的时候,echo 语句就不会执行,这样就能关闭所有的日志打印

也可以在 t.sh 中加一个变量,表示是否开启日志,当开启的时候,才会有日志打印,开关关闭时,同时会关闭日志打印功能,调整后的 t.sh 内容如下

#!/bin/bash LOG_OPEN=0 function log() { [ $LOG_OPEN -eq 1 ] && echo "$(date '+%Y-%m-%d %H:%M:%S') $@"}

需要开启日志的时候,把 LOG_OPEN 设置为1,关闭日志打印,设置为0即可

日志等级

在不同的脚本逻辑中,打印的日志应该有不同的作用,有些是临时变量值的输出,作为调试用的,有些是一些状态转换或者达到不同阶段的提示信息,还有些是严重的错误,需要重点输出并提醒用户

以上这些可以通过日志等级来实现,把日志划分等级,不同的等级屏幕上输出不同的颜色,便于查看,直接来看修改后的 t.sh 脚本内容吧

#!/bin/bash #日志级别 debug-1, info-2, warn-3, error-4, always-5 LOG_LEVEL=3 #调试日志 function log_debug(){ content="[DEBUG] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 1 ] && echo -e "\033[32m" ${content} "\033[0m"} #信息日志 function log_info(){ content="[INFO] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 2 ] && echo -e "\033[32m" ${content} "\033[0m"} #警告日志 function log_warn(){ content="[WARN] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 3 ] && echo -e "\033[33m" ${content} "\033[0m"} #错误日志 function log_err(){ content="[ERROR] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 4 ] && echo -e "\033[31m" ${content} "\033[0m"} #一直都会打印的日志 function log_always(){ content="[ALWAYS] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 5 ] && echo -e "\033[32m" ${content} "\033[0m"}

把日志级别分成 5 个等级,分别是 : debug日志、info日志、警告日志、错误日志、一直都打印的日志 ,每个级别对应一个函数接口,而且每个级别可以定义不同的字符颜色,方便在屏幕上查看错误以及警告,上述脚本中错误日志是红色,警告日志是黄色,其他级别的日志是绿色

修改 ta.sh 脚本, 内容如下

#!/bin/bash source ./t.sh log_debug "this is debug log..."log_info "this is info log..."log_warn "this is warn log..."log_err "this is error log..."log_always "this is always log.."

把 t.sh 中 LOG_LEVEL 设置为 1 , 执行 ./ta.sh 命令,结果如下

image-20230818113711282

再次调整 t.sh 中 LOG_LEVEL 为 3 , 执行 ./ta.sh 命令,结果如下

image-20230818113733186

从上面两次结果可以知道,日志级别设置为 debug级别 ( LOG_LEVEL = 1 ) 时,所有的等级的日志都会输出,当把日志级别设置为 info级别 ( LOG_LEVEL = 3 ) 后,只输出 warn日志、error日志 以及 always日志

如果想关闭所有级别的日志,把日志级别调到比 always日志 更高的级别,也即 LOG_LEVEL 的值大于 5 就行了

写入文件

当脚本是定时调用的时候,有时需要查询一段时间内脚本运行情况,这种情况下脚本一般都是后台运行的,要查询一段时间的日志,就需要把日志写入到日志文件中

比如:定时备份数据库的shell脚本,就需要记录下每次备份时的情况,便于后期查询用

调整下 t.sh 脚本,增加日志写入文件语句,修改后的脚本内容如下

#!/bin/bash #日志级别 debug-1, info-2, warn-3, error-4, always-5 LOG_LEVEL=3 #日志文件 LOG_FILE=./log.txt #调试日志 function log_debug(){ content="[DEBUG] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 1 ] && echo $content >> $LOG_FILE && echo -e "\033[32m" ${content} "\033[0m"} #信息日志 function log_info(){ content="[INFO] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 2 ] && echo $content >> $LOG_FILE && echo -e "\033[32m" ${content} "\033[0m"} #警告日志 function log_warn(){ content="[WARN] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 3 ] && echo $content >> $LOG_FILE && echo -e "\033[33m" ${content} "\033[0m"} #错误日志 function log_err(){ content="[ERROR] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 4 ] && echo $content >> $LOG_FILE && echo -e "\033[31m" ${content} "\033[0m"} #一直都会打印的日志 function log_always(){ content="[ALWAYS] $(date '+%Y-%m-%d %H:%M:%S') $@" [ $LOG_LEVEL -le 5 ] && echo $content >> $LOG_FILE && echo -e "\033[32m" ${content} "\033[0m"}

实际上是在每个日志级别的接口中增加了 echo $content >> $LOG_FILE 语句,表示将日志写入文件中, $LOG_FILE 表示日志文件

目前日志级别是 warn日志 级别,执行 ./ta.sh 命令,结果如下

image-20230818113822672

从上述结果可以看出,执行 ./ta.sh 命令之后,除了屏幕会输出日志外,本地目录下也会生成一个 log.txt 文件,文件内容和屏幕上的日志是一样的

小结

本文介绍了shell脚本中日志打印的一些技巧, 这些技巧都是从实践中总结出来的,文中提供了脚本的全部代码,可以拿来直接使用,也可根据实际的需求自行调整



【本文地址】

公司简介

联系我们

今日新闻


点击排行

实验室常用的仪器、试剂和
说到实验室常用到的东西,主要就分为仪器、试剂和耗
不用再找了,全球10大实验
01、赛默飞世尔科技(热电)Thermo Fisher Scientif
三代水柜的量产巅峰T-72坦
作者:寞寒最近,西边闹腾挺大,本来小寞以为忙完这
通风柜跟实验室通风系统有
说到通风柜跟实验室通风,不少人都纠结二者到底是不
集消毒杀菌、烘干收纳为一
厨房是家里细菌较多的地方,潮湿的环境、没有完全密
实验室设备之全钢实验台如
全钢实验台是实验室家具中较为重要的家具之一,很多

推荐新闻


图片新闻

实验室药品柜的特性有哪些
实验室药品柜是实验室家具的重要组成部分之一,主要
小学科学实验中有哪些教学
计算机 计算器 一般 打孔器 打气筒 仪器车 显微镜
实验室各种仪器原理动图讲
1.紫外分光光谱UV分析原理:吸收紫外光能量,引起分
高中化学常见仪器及实验装
1、可加热仪器:2、计量仪器:(1)仪器A的名称:量
微生物操作主要设备和器具
今天盘点一下微生物操作主要设备和器具,别嫌我啰嗦
浅谈通风柜使用基本常识
 众所周知,通风柜功能中最主要的就是排气功能。在

专题文章

    CopyRight 2018-2019 实验室设备网 版权所有 win10的实时保护怎么永久关闭